Can one of the admins verify this patch?

We actually have multiple PRs open to add this api (#9012 #9017 #7878) . #7878 stalled failing tests. I took a look and concluded some BAO changes would resolve that #8697 but no-one came back to that PR & reviewed / tested them so they never got merged & hence #7878 stalled.

I suspect if I get the tests to run you will see the same fails here. NB if you wish to test / review #8697please leave comments as to what you do.

Specific to this PR - great you have had a go at generated examples - they are actually generated from the unit tests normally - e.g https://github.com/civicrm/civicrm-core/blob/master/tests/phpunit/api/v3/PhoneTest.php#L62-L62

Also, this is quite different to our standard apis - which are much more like #7878 - we do try to keep them standardised so we'd probably need to discuss / understand a case for something different (and we would try to find a more standardised way to do it if possible)

this can be closed now as has been superseded by #9049

ok thanks. If you want to revisit the non-standard parts might be best to discuss on chat.civicrm.org - but also note you can implement a custom api in an extension